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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.3 1 1 : Generic Integration Reference Point (IRP) management; Requirements 

32.312: Generic Integration Reference Point (IRP) management; Information Service (IS) 

32.313: Generic Integration Reference Point (IRP) management; Common Object Request Broker 

Architecture (CORBA) Solution Set (SS) 

32.314: Generic Integration Reference Point (IRP) management; Common Management Information 

Protocol (CMIP) Solution Set (SS). 
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Scope 



The present document specifies the CORBA Solution Set for Generic Integration Reference Point (IRP) management 
whose capabiHties are specified in 3GPP TS 32.312 [1], the Generic IRP management: Information Service. 

This Solution Set specification is related to TS 32.312 V6.1.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Service (IS)". 

[2] 3GPP TS 32.3 11: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[3] 3GPP TS 32.1 1 1-2: "Telecommunication management; Alarm Integration Reference Point (IRP); 

Information Service (IS)". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.312 [1] apply. 
IRP document version number string (or "IRPVersion"): See 3GPP TS 32.31 1 [2] subclause 3.1. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

IOC Information Object Class 

OMG Object Management Group 

SS Solution Set 



£75/ 



3GPP TS 32.313 version 6.2.0 Release 6 



ETSI TS 132 313 V6.2.0 (2005-09) 



4 Architectural Features 

The overall architectural feature of this IRP is specified in 3G TS 32.312 [1]. This clause specifies features that are 
specific to the CORBA SS. 

Abstract IOC 

The capabilities of the Generic IRP management: IS [1] are captured by the definition of an IOC called 
ManagedGenericIRP. This IOC is an abstract class and is mapped to a MOC of the same name. The MOC is intended 
for inheritance by other MOCs specified in Interface IRPs such as AlarmlRP [3], NotificationIRP [4], etc. 



5. Mapping 

5.1 Operation mapping 

Generic IRP management: IS [1] defines semantics of operation visible across the Itf-N. Table 1 indicates mapping of 
these operations to their equivalents defined in this SS. 

Table 5.1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation TS 32.312 [1] 


SS Method 


Qualifier 


getlRPVersion 


get irp versions 


M 


getOperationProfile 


get interface irp operation profile 





getNotificationProfile 


get interface irp notification profile 






5.2 Operation parameter mapping 



Generic IRP management: IS [1] defines semantics of parameters carried in operations across the Itf-N. The following 
set of tables indicates the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 5.2 Mapping from IS getiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


versionNumberSet 


Return value of type 
GenericlRPIVIanagementConstDefsiiVersionNumberSet 


M 


status 


Exceptions: 
GenericlRPManagementSystem::GetlRPVersions 


M 



Table 5.3 Mapping from IS getOperationProfile parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


iRPVersion 


GenericlRPIVIanagementGonstDefs;:VersionNumber 
this irp version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type 
GenericlRPIVIanagementGonstDefs::MetliodUst 


M 


status 


Exceptions: 

GenericlRPI\/lanagementSystem::GetlnterfacelRPOperationsProfi 

le, 

GenericlRPI\/lanagementSystem::OperationNotSupported, 

GenericlRPIVIanagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported 


M 
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Table 5.4 Mapping from IS getNotif icationProf lie parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


GenericlRPManagementConstDefs;:VersionNumber 
this irp version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type 
GenericlRPIVIanagementConstDefs::NotificationList 


M 


status 


Exceptions: 

GenericlRPI\/lanagementSystem::GetlnterfacelRPNotificationProf 

lie, 

GenericlRPI\/lanagementSystem::OperationNotSupported, 

GenericlRPIVIanagementSystem::lnvalidParameter, 

GenericlRPI\/lanagementSystem::ValueNotSupported 


M 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name 

'GenericlRPIVIanagementConstDefs.idI') 

//File : GenericIRPManagementConstDef s . idl 
#ifndef _GENERIC_IRP_MANAGEMENT_CONST_DEFS_IDL_ 
#define _GENERIC_IRP_MANAGEMENT_CONST_DEFS_IDL_ 

#include <TimeBase . idl> 

// This statement must appear after all include statements 
#pragma prefix "SgppsaS . org" 

/* ## Module: GenericIRPManagementConstDef s 

This module contains definitions commonly used among all IRPs . 

module GenericIRPManagementConstDef s 
( 

/■" 

Definition imported from CosTime. 

The time refers to time in Greenwich Time Zone. 

It also consists of a time displacement factor in the form of minutes of 

displacement from the Greenwich Meridian. 

typedef TimeBase : :UtcT IRPTime; 

enum Signal (OK, FAILURE, PARTIAL_FAILURE } ; 

/* 

The VersionNumber is a string that identifies the IRP specification name 
and its version number. See definition "IRP document version number 
string" or " IRPVersion" . 

The VersionNumberSet is a sequence of such VersionNumber. It is returned 
by get_XXX_IRP_versions ( ) . The sequence order has no significance. 

typedef string VersionNumber; 

typedef sequence <VersionNumber> VersionNumberSet; 

typedef string MethodName; 

typedef string ParameterName; 

typedef sequence <ParameterName> ParameterList; 

/* 

The Method defines the structure to be returned as part of 

get_supported_operations_prof lie ( ) . The name shall be the actual method 

name (ex. "attach_push" , "change__subscription_f liter" , etc.) 

The parameter_list contains a list of strings. Each string shall be 

the actual parameter name (ex. "manager_ref erence" , "filter", etc.) 

struct Method 
( 

MethodName name; 

ParameterList parameter_list ; 

}; 
/'^ 

List of all methods and their associated parameters. 

V 

typedef sequence <Method> MethodList; 

typedef string Notif IcationName; 

struct Notification 

( 

Notif IcationName name; 

ParameterList parameter_list ; 
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typedef sequence <Notif ication> Notif icationList; 

/* 

StringOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent . 

*/ 

union StringOpt switch (boolean) 

{ 

case TRUE: string value; 



/* 

ShortOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent . 

*/ 

union ShortOpt switch (boolean) 

{ 

case TRUE: short value; 



/* 

UnsignedShortOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent . 

*/ 

union UnsignedShortOpt switch (boolean) 

{ 

case TRUE: unsigned short value; 



/* 

LongOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent . 

*/ 



union LongOpt switch (boolean) 
{ 

case TRUE: long value; 



/* 

UnsignedLongOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent . 

*/ 

union UnsignedLongOpt switch (boolean) 

{ 

case TRUE: unsigned long value; 



); 



#endif // _GENERIC_IRP_MANAGEMENT_CONST_DEFS_IDL_ 



A.2 IDL specification (file name 

'GenericlRPIVIanagementSystem.idI') 

//File : GenericIRPManagementSystem. idl 
#ifndef _GENERIC_IRP_MANAGEMENT_SYSTEM_IDL_ 
#define _GENERIC_IRP_MANAGEMENT_SYSTEM_IDL_ 

#include <GenericIRPManagementConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module GenericIRPManagementSystem 
{ 

exception GetlnterfacelRPNotif icationProf lie ( string reason; }; 

exception GetlnterfacelRPOperationProf lie ( string reason; }; 

exception GetlRPVersions ( string reason; }; 



£75/ 



3GPP TS 32.31 3 version 6.2.0 Release 6 1 ETSI TS 1 32 31 3 V6.2.0 (2005-09) 

/* 

Exception thrown when an unsupported optional parameter 

is passed with information. 

The parameter shall be the actual unsupported parameter name. 

V 

exception ParameterNotSupported ( 

GenericIRPManagementConstDef s : :ParameterName parameter; } ; 

/* 

Exception thrown when an invalid parameter value is passed. 

The parameter shall be the actual parameter name. 

*/ 

exception InvalidParameter ( 

GenericIRPManagementConstDef s :: ParameterName parameter; }; 

/* 

Exception thrown when a valid but unsupported parameter value is passed. 

The parameter shall be the actual parameter name. 

V 

exception ValueNotSupported ( 

GenericIRPManagementConstDef s : :ParameterName parameter; }; 

/* 

Exception thrown when an unsupported optional method is called. 

V 

exception OperationNotSupported {}; 

interface GenericIRPManagement 
{ 

/* 

Return the list of all supported Interface IRP versions 

Each IRPVersion is defined by the rule in the definition 

"IRP document version number string" or "IRPVersion" 

(see subclause 3.1) . 

*/ 

GenericIRPManagementConstDef s : : VersionNumberSet get_irp_versions 

( 

) 

raises (GetlRPVersions) ; 

/* 

Return the list of all supported methods and their supported 

parameters for this Interface IRPVersion. 

V 

GenericIRPManagementConstDef s : :MethodList 

get_interf ace_irp_operation_prof lie 
( 

in GenericIRPManagementConstDef s : : VersionNumber this_irp_version 
) 

raises (GetlnterfacelRPOperationProf ile, 
OperationNotSupported, 
InvalidParameter, 
ValueNotSupported) ; 

/* 

Return the list of all supported notifications and their supported 

parameters for this Interface IRPVersion. 

*/ 

typedef GenericIRPManagementConstDef s ; ;Notif IcationList Notif IcationList; 

NotificationList get_interf ace_irp_notif ication_prof ile 
( 

in GenericIRPManagementConstDef s ; ; VersionNumber this_irp_version 
) 
raises (GetlnterfacelRPNotificationProfile, 

OperationNotSupported, 

InvalidParameter, 

ValueNotSupported) ; 

); 
}; 

#endif // _GENERIC_IRP_MANAGEMENT_SYSTEM_IDL_ 
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Annex B (informative): 
Change history 



Change history 


Date 


TSG# 


TSG Doc. 


CR 


Rev 


Subject/Comment 


Cat 


Old 


New 


Dec 2004 


S 26 


SP-040795 


-- 


-- 


Submitted to SA#26 for Approval 


-- 


1.0.0 


6.0.0 


Jun 2005 


S_28 


SP-050288 


0001 


— 


Correction of IDL syntax errors in 
GenericlRPManagement{ConstDefs|System}.idl 


F 


6.0.0 


6.1.0 


Sep 2005 


SA 29 


SP-050461 


0002 


-- 


Align the CORBA SS IDL with TS 32.1 50 Style Guide 


F 


6.1.0 


6.2.0 
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